Function            stateindex - get index for a given state

  Syntax              int stateindex(char *state);

  Prototype in        statehk.h

  Remarks             stateindex() looks up the state abbreviation given
                      in States[] and returns the index (array
                      subscript). The compare is case independent

  Return value        returns the index (array subscript) for the given
                      state, if found. If not found, returns -1.

  Note                see isstate() for the list of valid states

  See also            statehk.h
                      isstate(), iszip()

  Example             #include <statehk.h>

                      {
                           printf("AL is subscript %d\n",
                                  stateindex("AL"));
                      }

  Program output      AL is subscript 0